home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / jpsrc2.zip / JCDEFLTS.C < prev    next >
C/C++ Source or Header  |  1991-12-03  |  14KB  |  368 lines
  1. /*
  2.  * jcdeflts.c
  3.  *
  4.  * Copyright (C) 1991, Thomas G. Lane.
  5.  * This file is part of the Independent JPEG Group's software.
  6.  * For conditions of distribution and use, see the accompanying README file.
  7.  *
  8.  * This file contains optional default-setting code for the JPEG compressor.
  9.  * User interfaces do not have to use this file, but those that don't use it
  10.  * must know a lot more about the innards of the JPEG code.
  11.  */
  12.  
  13. #include "jinclude.h"
  14.  
  15.  
  16. LOCAL void
  17. add_huff_table (compress_info_ptr cinfo,
  18.         HUFF_TBL **htblptr, const UINT8 *bits, const UINT8 *val)
  19. /* Define a Huffman table */
  20. {
  21.   if (*htblptr == NULL)
  22.     *htblptr = (HUFF_TBL *) (*cinfo->emethods->alloc_small) (SIZEOF(HUFF_TBL));
  23.   
  24.   memcpy((void *) (*htblptr)->bits, (const void *) bits,
  25.      SIZEOF((*htblptr)->bits));
  26.   memcpy((void *) (*htblptr)->huffval, (const void *) val,
  27.      SIZEOF((*htblptr)->huffval));
  28.  
  29.   /* Initialize sent_table FALSE so table will be written to JPEG file.
  30.    * In an application where we are writing non-interchange JPEG files,
  31.    * it might be desirable to save space by leaving default Huffman tables
  32.    * out of the file.  To do that, just initialize sent_table = TRUE...
  33.    */
  34.  
  35.   (*htblptr)->sent_table = FALSE;
  36. }
  37.  
  38.  
  39. LOCAL void
  40. std_huff_tables (compress_info_ptr cinfo)
  41. /* Set up the standard Huffman tables (cf. JPEG-8-R8 section 13.3) */
  42. {
  43.   static const UINT8 dc_luminance_bits[17] =
  44.     { /* 0-base */ 0, 0, 1, 5, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0, 0, 0 };
  45.   static const UINT8 dc_luminance_val[] =
  46.     { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
  47.   
  48.   static const UINT8 dc_chrominance_bits[17] =
  49.     { /* 0-base */ 0, 0, 3, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 0 };
  50.   static const UINT8 dc_chrominance_val[] =
  51.     { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 };
  52.   
  53.   static const UINT8 ac_luminance_bits[17] =
  54.     { /* 0-base */ 0, 0, 2, 1, 3, 3, 2, 4, 3, 5, 5, 4, 4, 0, 0, 1, 0x7d };
  55.   static const UINT8 ac_luminance_val[] =
  56.     { 0x01, 0x02, 0x03, 0x00, 0x04, 0x11, 0x05, 0x12,
  57.       0x21, 0x31, 0x41, 0x06, 0x13, 0x51, 0x61, 0x07,
  58.       0x22, 0x71, 0x14, 0x32, 0x81, 0x91, 0xa1, 0x08,
  59.       0x23, 0x42, 0xb1, 0xc1, 0x15, 0x52, 0xd1, 0xf0,
  60.       0x24, 0x33, 0x62, 0x72, 0x82, 0x09, 0x0a, 0x16,
  61.       0x17, 0x18, 0x19, 0x1a, 0x25, 0x26, 0x27, 0x28,
  62.       0x29, 0x2a, 0x34, 0x35, 0x36, 0x37, 0x38, 0x39,
  63.       0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48, 0x49,
  64.       0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58, 0x59,
  65.       0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69,
  66.       0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78, 0x79,
  67.       0x7a, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89,
  68.       0x8a, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98,
  69.       0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5, 0xa6, 0xa7,
  70.       0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4, 0xb5, 0xb6,
  71.       0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3, 0xc4, 0xc5,
  72.       0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2, 0xd3, 0xd4,
  73.       0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda, 0xe1, 0xe2,
  74.       0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9, 0xea,
  75.       0xf1, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
  76.       0xf9, 0xfa };
  77.   
  78.   static const UINT8 ac_chrominance_bits[17] =
  79.     { /* 0-base */ 0, 0, 2, 1, 2, 4, 4, 3, 4, 7, 5, 4, 4, 0, 1, 2, 0x77 };
  80.   static const UINT8 ac_chrominance_val[] =
  81.     { 0x00, 0x01, 0x02, 0x03, 0x11, 0x04, 0x05, 0x21,
  82.       0x31, 0x06, 0x12, 0x41, 0x51, 0x07, 0x61, 0x71,
  83.       0x13, 0x22, 0x32, 0x81, 0x08, 0x14, 0x42, 0x91,
  84.       0xa1, 0xb1, 0xc1, 0x09, 0x23, 0x33, 0x52, 0xf0,
  85.       0x15, 0x62, 0x72, 0xd1, 0x0a, 0x16, 0x24, 0x34,
  86.       0xe1, 0x25, 0xf1, 0x17, 0x18, 0x19, 0x1a, 0x26,
  87.       0x27, 0x28, 0x29, 0x2a, 0x35, 0x36, 0x37, 0x38,
  88.       0x39, 0x3a, 0x43, 0x44, 0x45, 0x46, 0x47, 0x48,
  89.       0x49, 0x4a, 0x53, 0x54, 0x55, 0x56, 0x57, 0x58,
  90.       0x59, 0x5a, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68,
  91.       0x69, 0x6a, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78,
  92.       0x79, 0x7a, 0x82, 0x83, 0x84, 0x85, 0x86, 0x87,
  93.       0x88, 0x89, 0x8a, 0x92, 0x93, 0x94, 0x95, 0x96,
  94.       0x97, 0x98, 0x99, 0x9a, 0xa2, 0xa3, 0xa4, 0xa5,
  95.       0xa6, 0xa7, 0xa8, 0xa9, 0xaa, 0xb2, 0xb3, 0xb4,
  96.       0xb5, 0xb6, 0xb7, 0xb8, 0xb9, 0xba, 0xc2, 0xc3,
  97.       0xc4, 0xc5, 0xc6, 0xc7, 0xc8, 0xc9, 0xca, 0xd2,
  98.       0xd3, 0xd4, 0xd5, 0xd6, 0xd7, 0xd8, 0xd9, 0xda,
  99.       0xe2, 0xe3, 0xe4, 0xe5, 0xe6, 0xe7, 0xe8, 0xe9,
  100.       0xea, 0xf2, 0xf3, 0xf4, 0xf5, 0xf6, 0xf7, 0xf8,
  101.       0xf9, 0xfa };
  102.   
  103.   add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[0],
  104.          dc_luminance_bits, dc_luminance_val);
  105.   add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[0],
  106.          ac_luminance_bits, ac_luminance_val);
  107.   add_huff_table(cinfo, &cinfo->dc_huff_tbl_ptrs[1],
  108.          dc_chrominance_bits, dc_chrominance_val);
  109.   add_huff_table(cinfo, &cinfo->ac_huff_tbl_ptrs[1],
  110.          ac_chrominance_bits, ac_chrominance_val);
  111. }
  112.  
  113.  
  114. /* This is the sample quantization table given in JPEG-8-R8 sec 13.1,
  115.  * but expressed in zigzag order (as are all of our quant. tables).
  116.  * The spec says that the values given produce "good" quality, and
  117.  * when divided by 2, "very good" quality.  (These two settings are
  118.  * selected by quality=50 and quality=75 in j_set_quality, below.)
  119.  */
  120.  
  121.  
  122. static const QUANT_VAL std_luminance_quant_tbl[DCTSIZE2] = {
  123.   16,  11,  12,  14,  12,  10,  16,  14,
  124.   13,  14,  18,  17,  16,  19,  24,  40,
  125.   26,  24,  22,  22,  24,  49,  35,  37,
  126.   29,  40,  58,  51,  61,  60,  57,  51,
  127.   56,  55,  64,  72,  92,  78,  64,  68,
  128.   87,  69,  55,  56,  80, 109,  81,  87,
  129.   95,  98, 103, 104, 103,  62,  77, 113,
  130.  121, 112, 100, 120,  92, 101, 103,  99
  131. };
  132.  
  133. static const QUANT_VAL std_chrominance_quant_tbl[DCTSIZE2] = {
  134.   17,  18,  18,  24,  21,  24,  47,  26,
  135.   26,  47,  99,  66,  56,  66,  99,  99,
  136.   99,  99,  99,  99,  99,  99,  99,  99,
  137.   99,  99,  99,  99,  99,  99,  99,  99,
  138.   99,  99,  99,  99,  99,  99,  99,  99,
  139.   99,  99,  99,  99,  99,  99,  99,  99,
  140.   99,  99,  99,  99,  99,  99,  99,  99,
  141.   99,  99,  99,  99,  99,  99,  99,  99
  142. };
  143.  
  144.  
  145. LOCAL void
  146. add_quant_table (compress_info_ptr cinfo, int which_tbl,
  147.          const QUANT_VAL *basic_table, int scale_factor,
  148.          boolean force_baseline)
  149. /* Define a quantization table equal to the basic_table times */
  150. /* a scale factor (given as a percentage) */
  151. {
  152.   QUANT_TBL_PTR * qtblptr = & cinfo->quant_tbl_ptrs[which_tbl];
  153.   int i;
  154.   long temp;
  155.  
  156.   if (*qtblptr == NULL)
  157.     *qtblptr = (QUANT_TBL_PTR) (*cinfo->emethods->alloc_small) (SIZEOF(QUANT_TBL));
  158.  
  159.   for (i = 0; i < DCTSIZE2; i++) {
  160.     temp = ((long) basic_table[i] * scale_factor + 50L) / 100L;
  161.     /* limit the values to the valid range */
  162.     if (temp <= 0L) temp = 1L;
  163. #ifdef EIGHT_BIT_SAMPLES
  164.     if (temp > 32767L) temp = 32767L; /* QUANT_VALs are 'short' */
  165. #else
  166.     if (temp > 65535L) temp = 65535L; /* QUANT_VALs are 'UINT16' */
  167. #endif
  168.     if (force_baseline && temp > 255L)
  169.       temp = 255L;        /* limit to baseline range if requested */
  170.     (*qtblptr)[i] = (QUANT_VAL) temp;
  171.   }
  172. }
  173.  
  174.  
  175. GLOBAL void
  176. j_set_quality (compress_info_ptr cinfo, int quality, boolean force_baseline)
  177. /* Set or change the 'quality' (quantization) setting. */
  178. /* The 'quality' factor should be 0 (terrible) to 100 (very good). */
  179. /* Quality 50 corresponds to the JPEG basic tables given above; */
  180. /* quality 100 results in no quantization scaling at all. */
  181. /* If force_baseline is TRUE, quantization table entries are limited */
  182. /* to 0..255 for JPEG baseline compatibility; this is only an issue */
  183. /* for quality settings below 24. */
  184. {
  185.   /* Safety limit on quality factor.  Convert 0 to 1 to avoid zero divide. */
  186.   if (quality <= 0) quality = 1;
  187.   if (quality > 100) quality = 100;
  188.  
  189.   /* Convert quality rating to a percentage scaling of the basic tables.
  190.    * The basic table is used as-is (scaling 100) for a quality of 50.
  191.    * Qualities 50..100 are converted to scaling percentage 200 - 2*Q;
  192.    * note that at Q=100 the scaling is 0, which will cause add_quant_table
  193.    * to make all the table entries 1 (hence, no quantization loss).
  194.    * Qualities 1..50 are converted to scaling percentage 5000/Q.
  195.    */
  196.   if (quality < 50)
  197.     quality = 5000 / quality;
  198.   else
  199.     quality = 200 - quality*2;
  200.  
  201.   /* Set up two quantization tables using the specified quality scaling */
  202.   add_quant_table(cinfo, 0, std_luminance_quant_tbl, quality, force_baseline);
  203.   add_quant_table(cinfo, 1, std_chrominance_quant_tbl, quality, force_baseline);
  204. }
  205.  
  206.  
  207.  
  208. /* Default parameter setup for compression.
  209.  *
  210.  * User interfaces that don't choose to use this routine must do their
  211.  * own setup of all these parameters.  Alternately, you can call this
  212.  * to establish defaults and then alter parameters selectively.  This
  213.  * is the recommended approach since, if we add any new parameters,
  214.  * your code will still work (they'll be set to reasonable defaults).
  215.  *
  216.  * See above for the meaning of the 'quality' and 'force_baseline' parameters.
  217.  * Typically, the application's default quality setting will be passed to this
  218.  * routine.  A later call on j_set_quality() can be used to change to a
  219.  * user-specified quality setting.
  220.  *
  221.  * This routine sets up for a color image; to output a grayscale image,
  222.  * do this first and call j_monochrome_default() afterwards.
  223.  * (The latter can be called within c_ui_method_selection, so the
  224.  * choice can depend on the input file header.)
  225.  * Note that if you want a JPEG colorspace other than GRAYSCALE or YCbCr,
  226.  * you should also change the component ID codes, and you should NOT emit
  227.  * a JFIF header (set write_JFIF_header = FALSE).
  228.  *
  229.  * CAUTION: if you want to compress multiple images per run, it's safest
  230.  * to call j_c_defaults before *each* call to jpeg_compress (and
  231.  * j_c_free_defaults afterwards).  If this isn't practical, you'll have to
  232.  * be careful to reset any individual parameters that may change during
  233.  * the compression run.  The main thing you need to worry about at present
  234.  * is that the sent_table boolean in each Huffman table must be reset to
  235.  * FALSE before each compression; otherwise, Huffman tables won't get
  236.  * emitted for the second and subsequent images.
  237.  */
  238.  
  239. GLOBAL void
  240. j_c_defaults (compress_info_ptr cinfo, int quality, boolean force_baseline)
  241. /* NB: the external methods must already be set up. */
  242. {
  243.   short i;
  244.   jpeg_component_info * compptr;
  245.  
  246.   /* Initialize pointers as needed to mark stuff unallocated. */
  247.   cinfo->comp_info = NULL;
  248.   for (i = 0; i < NUM_QUANT_TBLS; i++)
  249.     cinfo->quant_tbl_ptrs[i] = NULL;
  250.   for (i = 0; i < NUM_HUFF_TBLS; i++) {
  251.     cinfo->dc_huff_tbl_ptrs[i] = NULL;
  252.     cinfo->ac_huff_tbl_ptrs[i] = NULL;
  253.   }
  254.  
  255.   cinfo->data_precision = 8;    /* default; can be overridden by input_init */
  256.   cinfo->density_unit = 0;    /* Pixel size is unknown by default */
  257.   cinfo->X_density = 1;        /* Pixel aspect ratio is square by default */
  258.   cinfo->Y_density = 1;
  259.  
  260.   cinfo->input_gamma = 1.0;    /* no gamma correction by default */
  261.  
  262.   /* Prepare three color components; first is luminance which is also usable */
  263.   /* for grayscale.  The others are assumed to be UV or similar chrominance. */
  264.   cinfo->write_JFIF_header = TRUE;
  265.   cinfo->jpeg_color_space = CS_YCbCr;
  266.   cinfo->num_components = 3;
  267.   cinfo->comp_info = (jpeg_component_info *)
  268.     (*cinfo->emethods->alloc_small) (4 * SIZEOF(jpeg_component_info));
  269.   /* Note: we allocate a 4-entry comp_info array so that user interface can
  270.    * easily change over to CMYK color space if desired.
  271.    */
  272.  
  273.   compptr = &cinfo->comp_info[0];
  274.   compptr->component_index = 0;
  275.   compptr->component_id = 1;    /* JFIF specifies IDs 1,2,3 */
  276.   compptr->h_samp_factor = 2;    /* default to 2x2 subsamples of chrominance */
  277.   compptr->v_samp_factor = 2;
  278.   compptr->quant_tbl_no = 0;    /* use tables 0 for luminance */
  279.   compptr->dc_tbl_no = 0;
  280.   compptr->ac_tbl_no = 0;
  281.  
  282.   compptr = &cinfo->comp_info[1];
  283.   compptr->component_index = 1;
  284.   compptr->component_id = 2;
  285.   compptr->h_samp_factor = 1;
  286.   compptr->v_samp_factor = 1;
  287.   compptr->quant_tbl_no = 1;    /* use tables 1 for chrominance */
  288.   compptr->dc_tbl_no = 1;
  289.   compptr->ac_tbl_no = 1;
  290.  
  291.   compptr = &cinfo->comp_info[2];
  292.   compptr->component_index = 2;
  293.   compptr->component_id = 3;
  294.   compptr->h_samp_factor = 1;
  295.   compptr->v_samp_factor = 1;
  296.   compptr->quant_tbl_no = 1;    /* use tables 1 for chrominance */
  297.   compptr->dc_tbl_no = 1;
  298.   compptr->ac_tbl_no = 1;
  299.  
  300.   /* Set up two quantization tables using the specified quality scaling */
  301.   j_set_quality(cinfo, quality, force_baseline);
  302.  
  303.   /* Set up two Huffman tables in case user interface wants Huffman coding */
  304.   std_huff_tables(cinfo);
  305.  
  306.   /* Initialize default arithmetic coding conditioning */
  307.   for (i = 0; i < NUM_ARITH_TBLS; i++) {
  308.     cinfo->arith_dc_L[i] = 0;
  309.     cinfo->arith_dc_U[i] = 1;
  310.     cinfo->arith_ac_K[i] = 5;
  311.   }
  312.  
  313.   /* Use Huffman coding, not arithmetic coding, by default */
  314.   cinfo->arith_code = FALSE;
  315.  
  316.   /* Color images are interleaved by default */
  317.   cinfo->interleave = TRUE;
  318.  
  319.   /* By default, don't do extra passes to optimize entropy coding */
  320.   cinfo->optimize_coding = FALSE;
  321.  
  322.   /* By default, use the simpler non-cosited sampling alignment */
  323.   cinfo->CCIR601_sampling = FALSE;
  324.  
  325.   /* No restart markers */
  326.   cinfo->restart_interval = 0;
  327. }
  328.  
  329.  
  330.  
  331. GLOBAL void
  332. j_monochrome_default (compress_info_ptr cinfo)
  333. /* Change the j_c_defaults() values to emit a monochrome JPEG file. */
  334. {
  335.   jpeg_component_info * compptr;
  336.  
  337.   cinfo->jpeg_color_space = CS_GRAYSCALE;
  338.   cinfo->num_components = 1;
  339.   /* Set single component to 1x1 subsampling */
  340.   compptr = &cinfo->comp_info[0];
  341.   compptr->h_samp_factor = 1;
  342.   compptr->v_samp_factor = 1;
  343. }
  344.  
  345.  
  346.  
  347. /* This routine releases storage allocated by j_c_defaults.
  348.  * Note that freeing the method pointer structs and the compress_info_struct
  349.  * itself are the responsibility of the user interface.
  350.  */
  351.  
  352. GLOBAL void
  353. j_c_free_defaults (compress_info_ptr cinfo)
  354. {
  355.   short i;
  356.  
  357. #define FREE(ptr)  if ((ptr) != NULL) \
  358.             (*cinfo->emethods->free_small) ((void *) ptr)
  359.  
  360.   FREE(cinfo->comp_info);
  361.   for (i = 0; i < NUM_QUANT_TBLS; i++)
  362.     FREE(cinfo->quant_tbl_ptrs[i]);
  363.   for (i = 0; i < NUM_HUFF_TBLS; i++) {
  364.     FREE(cinfo->dc_huff_tbl_ptrs[i]);
  365.     FREE(cinfo->ac_huff_tbl_ptrs[i]);
  366.   }
  367. }
  368.